﻿<html DIR="LTR" xmlns:tool="http://www.microsoft.com/tooltip" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ddue="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
  <head>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=utf-8" />
    <META NAME="save" CONTENT="history" />
    <title>Usando um procedimento armazenado com um status de retorno</title>
    
    <link rel="stylesheet" type="text/css" href="../local/Classic.css">
      
    </link>
    
    <script src="../local/script.js">
      
    </script><script src="../local/script_main.js">&amp;nbsp;</script>
  </head>
  <body>
    <!--Topic built:04/01/2010 05:03:30-->

    
    
    
    
    
    
    
    
    
    <div id="header">
      <table width="100%" id="topTable"><tr>
          <td align="left">
            <span id="headerBold">Usando um procedimento armazenado com um status de retorno</span>
          </td>
          <td align="right">
            
          </td>
        </tr></table>
      
      
      
    </div>
    <div id="mainSection">
      
        
        
    <font color="DarkGray">
      
    </font>
    <p />
    
    <p />
  
        <div id="introductionSection" class="section">
    <p>Um procedimento armazenado do SQL Server que você pode chamar é um que retorna um parâmetro de status ou resultado. Em geral, isso é usado para indicar o êxito ou a falha do procedimento armazenado. O Microsoft SQL Server JDBC Driver fornece a classe <a href="30710a63-c05d-47d9-9cf9-c087a1c76373.htm">SQLServerCallableStatement</a>, que pode ser usada para chamar esse tipo de procedimento armazenado e processar os dados que ele retorna.</p>
    <p>Ao chamar esse tipo de procedimento armazenado usando o driver JDBC, você deve usar a sequência de escape <code>call</code> do SQL em conjunto com o método <a href="265b024c-898a-4bd0-98b5-f06076717b9e.htm">prepareCall</a> da classe <a href="937292a6-1525-423e-a2b2-a18fd34c2893.htm">SQLServerConnection</a>. A sintaxe da sequência de escape <code>call</code> com um parâmetro de status de retorno é a seguinte:</p>
    <p>
      <code>{[?=]call procedure-name[([parameter][,[parameter]]...)]}</code>
    </p>
    <div style="margin: .5em 1.5em .5em 1.5em"><b>Observação: </b>
      Para obter mais informações sobre as sequências de escape do SQL, consulte <a href="00f9e25a-088e-4ac6-aa75-43eacace8f03.htm">Usando sequências de escape do SQL</a>.<p />
    </div>
    <p>Ao construir a sequência de escape <code> call </code>, especifique o parâmetro de status de retorno usando o caractere ? (ponto de interrogação). Esse caractere age como um espaço reservado para o valor de parâmetro que retornará do procedimento armazenado. Para especificar um valor para um parâmetro de status de retorno, é necessário especificar o tipo de dados do parâmetro usando o método <a href="82f8d608-efc1-4af8-a985-ec25d19420aa.htm">registerOutParameter</a> da classe <b>SQLServerCallableStatement</b> antes de executar o procedimento armazenado. </p>
    <div style="margin: .5em 1.5em .5em 1.5em"><b>Observação: </b>
      Ao usar o driver JDBC com um banco de dados do SQL Server, o valor que você especificar para o parâmetro de status de retorno no método <b>registerOutParameter</b> será sempre um inteiro, condição que você pode especificar usando o tipo de dados java.sql.Types.INTEGER.<p />
    </div>
    <p>Além disso, ao passar para o método <b>registerOutParameter</b> um valor para um parâmetro de status de retorno, você deve especificar não só o tipo de dados a ser usado para o parâmetro, mas também o posicionamento ordinal do parâmetro na chamada do procedimento armazenado. No caso do parâmetro de status de retorno, a posição ordinal será sempre 1 porque ele é sempre o primeiro parâmetro na chamada para o procedimento armazenado. Embora a classe <b>SQLServerCallableStatement</b> dê suporte ao uso do nome do parâmetro para indicar o parâmetro específico, você só pode usar o número de posição ordinal para parâmetros de status de retorno.</p>
    <p>Como exemplo, crie o seguinte procedimento armazenado no banco de dados de exemplo da AdventureWorks no SQL Server 2005:</p>
    <div class="sampleCode"><span codeLanguage="other"><pre>CREATE PROCEDURE CheckContactCity
   (@cityName CHAR(50))
AS
BEGIN
   IF ((SELECT COUNT(*)
   FROM Person.Address
   WHERE City = @cityName) &gt; 1)
   RETURN 1
ELSE
   RETURN 0
END</pre></span></div>
    <p>Esse procedimento armazenado retorna o valor de status 1 ou 0, dependendo se a cidade especificada no parâmetro cityName se encontra ou não na tabela Person.Address.</p>
    <p>No exemplo a seguir, uma conexão aberta com o banco de dados de exemplo da AdventureWorks é passada para a função, e o método <a href="e1367f39-23d7-4e26-b160-6d988d7e6988.htm">execute</a> é usado para chamar o procedimento armazenado CheckContactCity:</p>
    <div class="sampleCode"><span codeLanguage="other"><pre>public static void executeStoredProcedure(Connection con) {
   try {
      CallableStatement cstmt = con.prepareCall("{? = call dbo.CheckContactCity(?)}");
      cstmt.registerOutParameter(1, java.sql.Types.INTEGER);
      cstmt.setString(2, "Atlanta");
      cstmt.execute();
      System.out.println("RETURN STATUS: " + cstmt.getInt(1));
      cstmt.close();
   }
   catch (Exception e) {
      e.printStackTrace();
   }
}
</pre></span></div>
  </div><span id="seeAlsoSpan"><h1 class="heading">Consulte também</h1></span><div id="seeAlsoSection" class="section" name="collapseableSection"><a href="0041f9e1-09b6-4487-b052-afd636c8e89a.htm">Usando instruções com procedimentos armazenados</a><br /><br /></div><!--[if gte IE 5]>
			<tool:tip element="seeAlsoToolTip" avoidmouse="false"/><tool:tip element="languageFilterToolTip" avoidmouse="false"/><tool:tip element="roleInfoSpan" avoidmouse="false"/>
		<![endif]-->
      <div id="footer" class="section">
        
		<hr />
		
		<span id="fb" class="feedbackcss">
			
			
		</span>
		
		<a href="9bad553b-9e70-4696-8499-2e35f772a1e0.htm">
			
			© 2010 Microsoft Corporation. Todos os direitos reservados.
		</a>
 	
	
      </div>
    </div>
  </body>
</html>